Installation
On this page
Installation#
System-Wide Installation#
Installing the internetarchive
library globally on your system can be done with pip.
This is the recommended method for installing internetarchive
(see below for details on installing pip):
$ sudo pip install internetarchive
or, with easy_install:
$ sudo easy_install internetarchive
Either of these commands will install the internetarchive
Python library and ia
command-line tool on your system.
Note: Some versions of Mac OS X come with Python libraries that are required by internetarchive
(e.g. the Python package six
).
This can cause installation issues. If your installation is failing with a message that looks something like:
OSError: [Errno 1] Operation not permitted: '/var/folders/bk/3wx7qs8d0x79tqbmcdmsk1040000gp/T/pip-TGyjVo-uninstall/System/Library/Frameworks/Python.framework/Versions/2.7/Extras/lib/python/six-1.4.1-py2.7.egg-info'
You can use the --ignore-installed
parameter in pip
to ignore the libraries that are already installed, and continue with the rest of the installation:
$ sudo pip install --ignore-installed internetarchive
More details on this issue can be found here: https://github.com/pypa/pip/issues/3165
Installing Pip#
Pip can be installed with the get-pip.py script:
$ curl -LOs https://bootstrap.pypa.io/get-pip.py
$ python get-pip.py
virtualenv#
If you don’t want to, or can’t, install the package system-wide you can use virtualenv
to create an isolated Python environment.
First, make sure virtualenv
is installed on your system. If it’s not, you can do so with pip:
$ sudo pip install virtualenv
With easy_install
:
$ sudo easy_install virtualenv
Or your systems package manager, apt-get
for example:
$ sudo apt-get install python-virtualenv
Once you have virtualenv
installed on your system, create a virtualenv:
$ mkdir myproject
$ cd myproject
$ virtualenv venv
New python executable in venv/bin/python
Installing setuptools, pip............done.
Activate your virtualenv:
$ . venv/bin/activate
Install internetarchive
into your virtualenv:
$ pip install internetarchive
Binaries#
Binaries are also available for the ia
command-line tool:
$ curl -LOs https://archive.org/download/ia-pex/ia
$ chmod +x ia
Binaries are generated with PEX. The only requirement for using the binaries is that you have Python 3 installed on a Unix-like operating system.
For more details on the command-line interface please refer to the README, or ia help
.
Python 2#
If you are on an older operating system that only has Python 2 installed, it’s highly suggested that you upgrade to Python 3. If for any reason you are not able to, the latest version of ia
that supports Python 2 is 2.3.0.
You can install and use version v2.3.0 with pip:
$ pip install internetarchive==2.3.0
You can also download a binary of v2.3.0:
$ curl -LOs https://archive.org/download/ia-pex/ia-py2
$ chmod +x ia-py2
Snap#
You can install the latest ia
snap, and help testing the most recent changes of the master branch in all the supported Linux distros with:
$ sudo snap install ia --edge
Every time a new version of ia
is pushed to the store, you will get it updated automatically.
Get the Code#
Internetarchive is actively developed on GitHub.
You can either clone the public repository:
$ git clone git://github.com/jjjake/internetarchive.git
Download the tarball:
$ curl -OL https://github.com/jjjake/internetarchive/tarball/master
Or, download the zipball:
$ curl -OL https://github.com/jjjake/internetarchive/zipball/master
Once you have a copy of the source, you can install it into your site-packages easily:
$ python setup.py install